PATH  Mac OS 8 and 9 Developer Documentation > Human Interface Toolbox > Icon Services and Utilities
> Obtaining and Using Icons With Icon Services

   

ReleaseIconRef

Decrements the reference count for an IconRef .

pascal OSErr ReleaseIconRef (IconRef iconRef);

iconRef
A pointer to a value of type IconRef whose reference count you wish to decrement.

function result
A result code. See Icon Services Result Codes for a description of possible return values.
DISCUSSION
When an IconRef 's reference count reaches 0, all memory allocated for the IconRef is marked as disposable. Any subsequent attempt to use the IconRef returns a result code of -2580 (invalidIconRefErr).

© 1999 Apple Computer, Inc. – (Last Updated 03 Dec 99)